package com.newshub.business.mapper;

import com.newshub.business.entity.Users;
import com.newshub.business.dto.UserQueryDTO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDateTime;
import java.util.List;

/**
 * 用户Mapper接口
 */
@Mapper
public interface UsersMapper {
    
    /**
     * 根据ID查询用户
     * @param id 用户ID
     * @return 用户对象
     */
    Users selectById(@Param("id") Integer id);
    
    /**
     * 插入用户
     * @param user 用户对象
     * @return 插入数量
     */
    int insert(Users user);
    
    /**
     * 根据ID删除用户
     * @param id 用户ID
     * @return 删除数量
     */
    int deleteById(@Param("id") Integer id);
    
    /**
     * 根据用户名查询用户
     * @param username 用户名
     * @return 用户对象
     */
    Users selectByUsername(@Param("username") String username);
    
    /**
     * 根据邮箱查询用户
     * @param email 邮箱
     * @return 用户对象
     */
    Users selectByEmail(@Param("email") String email);
    
    /**
     * 根据角色查询用户
     * @param role 用户角色
     * @return 用户列表
     */
    List<Users> selectByRole(@Param("role") String role);
    
    /**
     * 根据状态查询用户
     * @param status 用户状态
     * @return 用户列表
     */
    List<Users> selectByStatus(@Param("status") Integer status);
    
    /**
     * 查询所有用户
     * @return 用户列表
     */
    List<Users> selectAllUsers();
    
    /**
     * 批量插入用户
     * @param usersList 用户列表
     * @return 插入数量
     */
    int insertBatch(@Param("usersList") List<Users> usersList);
    
    /**
     * 根据ID删除用户
     * @param id 用户ID
     * @return 删除数量
     */
    int deleteByIdCustom(@Param("id") Integer id);
    
    /**
     * 根据ID更新用户
     * @param user 用户对象
     * @return 更新数量
     */
    int updateById(Users user);
    
    /**
     * 更新用户信息
     * @param users 用户对象
     * @return 更新数量
     */
    int updateUserInfo(Users users);
    
    /**
     * 更新用户密码
     * @param id 用户ID
     * @param passwordHash 新密码哈希
     * @return 更新数量
     */
    int updatePassword(@Param("id") Integer id, @Param("passwordHash") String passwordHash);
    
    /**
     * 更新用户状态
     * @param id 用户ID
     * @param status 新状态
     * @return 更新数量
     */
    int updateStatus(@Param("id") Integer id, @Param("status") Integer status);
    
    /**
     * 更新最后登录时间和登录次数
     * @param id 用户ID
     * @param lastLoginTime 最后登录时间
     * @return 更新数量
     */
    int updateLoginInfo(@Param("id") Integer id, @Param("lastLoginTime") LocalDateTime lastLoginTime);
    
    /**
     * 根据用户名或邮箱查询用户
     * @param usernameOrEmail 用户名或邮箱
     * @return 用户对象
     */
    Users selectByUsernameOrEmail(@Param("usernameOrEmail") String usernameOrEmail);
    
    /**
     * 分页查询用户
     * @param queryDTO 查询条件
     * @param offset 偏移量
     * @param limit 限制数量
     * @return 用户列表
     */
    List<Users> selectByPage(@Param("queryDTO") UserQueryDTO queryDTO, 
                             @Param("offset") int offset, 
                             @Param("limit") int limit);
    
    /**
     * 统计分页查询的总数
     * @param queryDTO 查询条件
     * @return 总数
     */
    long countByPage(UserQueryDTO queryDTO);
    
    /**
     * 统计所有用户数量
     * @return 用户总数
     */
    long countAllUsers();
    
    /**
     * 根据角色统计用户数量
     * @param role 角色
     * @return 用户数量
     */
    long countByRole(@Param("role") String role);
    
    /**
     * 根据状态统计用户数量
     * @param status 状态
     * @return 用户数量
     */
    long countByStatus(@Param("status") Integer status);
    
    /**
     * 批量删除用户
     * @param ids 用户ID列表
     * @return 删除数量
     */
    int deleteBatchByIds(@Param("ids") List<Integer> ids);
    
    /**
     * 批量更新用户状态
     * @param ids 用户ID列表
     * @param status 新状态
     * @return 更新数量
     */
    int updateBatchStatus(@Param("ids") List<Integer> ids, @Param("status") Integer status);
}